home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / text / misc / fill.lha / Fill / Amiga.DOC next >
Text File  |  1993-01-21  |  2KB  |  53 lines
  1.    NAME
  2.      fill - a simple text formatter
  3.  
  4.    SYNOPSIS
  5.      fill [[-b] [-j] | [-c]] [-d] [-r n] [-l n] [-p n]
  6.      fill ?
  7.  
  8.    DESCRIPTION
  9.      Fill is a simple text formatter meant to be used from within your editor
  10.      to provide a functionality similar to the ^B command in WordStar.  This
  11.      presumes your editor can pipe an object through a filter.  In vi, you
  12.      would do something like "!}fill" to word wrap a paragraph.  Of course,
  13.      you may, in the spirit of Unix, find other uses for it.  For example,
  14.      Fill has the side-effect of de-tabifying lines passed to it.
  15.  
  16.      The following options pertain:
  17.           -b   box the output lines
  18.           -c   center the lines
  19.           -d   the text block has a delimiter on the left side
  20.           -j   justify the right margin
  21.           -p n set paragraph indent value to "n"
  22.           -r n set right margin to column "n", defaults to 72
  23.           -l n set left margin to column "n", defaults to 1
  24.  
  25.      The "-d" option is used to preserve a left hand delimiter on the text,
  26.      such as might be used on a comment block in a source file.  It does this
  27.      by taking the first white-space delimited word in the input text and
  28.      replicating it down the left-hand side of the output text block.  It
  29.      concurrently drops the first word on each line in its input.
  30.  
  31.      The "-p" option is used to set a paragraph indent.  The indent value
  32.      specified is added to the left margin for the first line of output.
  33.      Negative values may be used for hanging indents.
  34.  
  35.      On the Amiga, "Fill ?" will print a usage message.
  36.  
  37.    FEATURES
  38.      Fill has no practical limit on line lengths (except when centering).
  39.  
  40.    BUGS
  41.      The justification algorithm is a little crude.
  42.      The delimited text option can be easily confused.
  43.      Abbreviations (eg.  this one) get an extra space after them.
  44.      Fill makes no attempt to preserve existing indentations or blank lines
  45.      (this could be construed as a feature).
  46.  
  47.    AUTHOR
  48.      Chad R. Larson
  49.      Ported to the Commodore Amiga by Daniel J. Barrett, barrett@cs.umass.edu
  50.  
  51.    SEE ALSO
  52.      pr(1), nroff(1), troff(1)    [On a UNIX machine.]
  53.      The file "README.Amiga."    [On an Amiga.]